home *** CD-ROM | disk | FTP | other *** search
/ SGI Varsity Update 1998 August / SGI Varsity Update 1998 August.iso / docs / relnotes / ftn77_fe / ch4.z / ch4
Text File  |  1998-07-29  |  15KB  |  462 lines
  1.  
  2.  
  3.  
  4.                                                - 1 -
  5.  
  6.  
  7.  
  8.                     7.2.1 Fortran 77 Front-End Release Notes
  9.  
  10.  
  11.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.                                                - 2 -
  70.  
  71.  
  72.  
  73.                     DDDDooooccccuuuummmmeeeennnntttt NNNNuuuummmmbbbbeeeerrrr 000000007777----1111666655559999----000011110000
  74.  
  75.  
  76.                     4.  _N_e_w__F_e_a_t_u_r_e_s__o_f__T_h_i_s__R_e_l_e_a_s_e
  77.  
  78.                     This chapter contains the differences between
  79.                     this release and the 7.2 release of the MIPSpro
  80.                     Fortran 77 compiler.  It also summarizes the
  81.                     differences between the 7.2 release and the 7.1
  82.                     release of MIPSpro Fortran 77 compiler.
  83.  
  84.  
  85.                     4.1  _N_e_w__F_e_a_t_u_r_e_s__i_n__M_I_P_S_p_r_o__7_._2_._1
  86.  
  87.  
  88.  
  89.                     4.1.1  _O_p_e_n_M_P__S_u_p_p_o_r_t   MIPSpro Fortran 77 7.2.1
  90.                     now supports the OpenMP application programming
  91.                     interface (API) when used in conjunction with
  92.                     the -_m_p flag.  The -_m_p flag enables the
  93.                     processing of the parallel (MP) directives,
  94.                     including the original SGI/PCF directives as
  95.                     well as the OpenMP directives.  To selectively
  96.                     disable one or the other set of directives, add
  97.                     the following -MP option group flag to the -_m_p
  98.                     flag:
  99.  
  100.                     -MP:old_mp=off
  101.                         disable processing of the original SGI/PCF
  102.                         directives, but retain the processing of
  103.                         OpenMP directives.
  104.  
  105.                     -MP:open_mp=off
  106.                         disable processing of the OpenMP directives,
  107.                         but retain processing of the original
  108.                         SGI/PCF directives.
  109.  
  110.  
  111.  
  112.                     You must have libmp from patchSG0002773
  113.                     installed if you plan to work with OpenMP
  114.                     support.
  115.  
  116.                     For more information about OpenMP support in
  117.                     MIPSpro Fortran 77, please refer to the MIPSpro
  118.                     Fortran 77 Programmer's Guide.  For general
  119.                     information about OpenMP please refer to the
  120.                     following web page:
  121.  
  122.                     http://www.openmp.org/
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.                                                - 3 -
  136.  
  137.  
  138.  
  139.                     4.2  _-_O_P_T_:_I_E_E_E___c_o_m_p_a_r_i_s_o_n_s_=_n_o_p_t_i_o_n
  140.  
  141.  
  142.                     The -OPT:IEEE_comparisons=n option has been
  143.                     renamed to -OPT:IEEE_NaN_inf=n whose definition
  144.                     under the -OPT option control group is as
  145.                     follows:
  146.  
  147.  
  148.                       IEEE_NaN_inf=n
  149.  
  150.                           IEEE_NaN_inf=ON forces all  operations which might have
  151.                           IEEE-754  NaN or infinity operands to yield results
  152.                           that conform to ANSI/IEEE 754-1985, the IEEE Standard for
  153.                           Binary Floating-point Arithmetic, which specifies
  154.                           standard for NaN and inf operands.  Specify ON or OFF for
  155.                           setting.  The default is IEEE_NaN_inf=OFF.
  156.  
  157.                           IEEE_NaN_inf=OFF produces non-IEEE results for various
  158.                           operations.  For example, x=x is treated as TRUE without
  159.                           executing a test, and x/x will be simplified to 1
  160.                           without dividing.  Turning this option on may suppress
  161.                           many such common optimizations and hurt performance as a
  162.                           result.
  163.  
  164.  
  165.                     For more information please consult the new man
  166.                     page opt(5).
  167.  
  168.  
  169.  
  170.  
  171.                     4.3  _N_e_w__F_e_a_t_u_r_e_s__i_n__M_I_P_S_p_r_o__7_._2_.
  172.  
  173.  
  174.  
  175.                     4.3.1  _R_e_p_a_c_k_a_g_i_n_g__o_f__F_r_o_n_t_-_E_n_d__S_u_b_s_y_s_t_e_m_s   As
  176.                     of the 7.2 release, the MIPSpro Fortran 77
  177.                     front-end subsystems are packaged on their own
  178.                     separate CD. Before installing the MIPSpro
  179.                     Fortran 77 Front-end subsystems you must first
  180.                     install compiler_dev, compiler_eoe, ftn_dev, and
  181.                     ftn_eoe from the IRIX Development Foundation CD
  182.                     (On IRIX 6.5 *_eoe subsystems are on the IRIX
  183.                     Foundation CD).
  184.  
  185.                     Should you desire to use the new 7.2.1 Fortran
  186.                     77 runtime libraries, you must install
  187.                     patchSG0002759.ftn_dev_sw
  188.                     patchSG0002759.ftn_eoe_sw (*.sw64 subsystems are
  189.                     required only for 64-bit operation).
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.                                                - 4 -
  202.  
  203.  
  204.  
  205.                     NOTE:
  206.  
  207.                             Patch 2759 contains both ftn77_eoe and ftn_eoe
  208.                             subsystems.  One set of these subsystems
  209.                             is marked as installable (NA) while the other is
  210.                             marked as not installable (NX).
  211.  
  212.                             When installing patch 2759 on the 7.2.1 and 7.2
  213.                             compiler runtimes containing ftn_eoe,
  214.                             the ftn77_eoe subsystems are displayed as not
  215.                             installable (NX).
  216.  
  217.                             When installing patch 2759 on earlier compilers
  218.                             runtimes containing ftn77_eoe,
  219.                             the ftn_eoe subsystems are displayed as not
  220.                             installable (NX).
  221.  
  222.  
  223.  
  224.  
  225.  
  226.                     4.3.2  _O_p_t_i_o_n__t_o__u_s_e__F_o_r_t_r_a_n__9_0__l_i_b_r_a_r_y   The
  227.                     -_c_r_a_y_l_i_b_s option allows you to use the Fortran
  228.                     90 library, libfortran.so, (based on the Cray
  229.                     FFIO library) to link your program.  Using this
  230.                     option requires installation of Patch 2759
  231.                     (available on the IRIX Development Foundation
  232.                     CD's).  Note that only standard Fortran 77 I/O
  233.                     operations are supported in this release.  If
  234.                     you use any SGI Fortran 77 extensions
  235.                     (particularly ISAM and variable formats) you
  236.                     cannot use the -_c_r_a_y_l_i_b_s option.
  237.  
  238.  
  239.                     4.3.3  _N_e_w__O_p_t_i_o_n_s__a_n_d__D_e_f_a_u_l_t_s   A new
  240.                     -_D_E_B_U_G:_o_p_t_i_o_n control group has been created to
  241.                     allow insertion of code to assist in the
  242.                     debugging of programs.  For example,
  243.                     -_D_E_B_U_G:_d_i_v__c_h_e_c_k=_N replaces -_T_E_N_V:_c_h_e_c_k__d_i_v=_N
  244.                     and the 7.2.1 compiler, by default, inserts code
  245.                     to check for divide by zero (N=1).
  246.  
  247.                     _N_O_T_E:  The default value for -_T_E_N_V:_c_h_e_c_k__d_i_v=_N
  248.                     under MIPSpro 7.1 was N=0 (no checks).
  249.  
  250.                     For more information, please refer to the _f_7_7(1)
  251.                     and _D_E_B_U_G__g_r_o_u_p(5) man pages.
  252.  
  253.                     The -_L_I_S_T: options control group has been
  254.                     enhanced to the create a listing file (.l) that
  255.                     contains the values of all flags  modified,
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.                                                - 5 -
  268.  
  269.  
  270.  
  271.                     directly in the command line, or indirectly as a
  272.                     side effect of other options. For example:
  273.  
  274.                     % f77 -n32 -LIST:options=ON foo.f
  275.  
  276.                     will create foo.l which contains a listing that
  277.                     contains the default values of certain options
  278.                     from the -OPT, -LNO, -TARG and -TENV option
  279.                     control groups.
  280.  
  281.                     The following command:
  282.  
  283.                     % f77 -n32 -LIST:all_options=ON foo.f
  284.  
  285.                     will create foo.l which contains a listing that
  286.                     contains the default values of all options from
  287.                     all of the option control groups.
  288.  
  289.                     For more information, please refer to the _f_7_7(1)
  290.                     man page.
  291.  
  292.  
  293.                     4.3.4  _O_b_s_o_l_e_t_e__O_p_t_i_o_n_s   Several compile-time
  294.                     flags have been obsoleted. These include:
  295.                     -_T_E_N_V:_m_i_s_a_l_i_g_n_e_m_n_t=_N, -_T_E_N_V:_a_l_i_g_n__e_x_t_e_r_n=_N and
  296.                     -_T_E_N_V:_a_l_i_g_n_e_d=_T_R_U_E.  Their use will generate a
  297.                     warning message in both the compiler front-end
  298.                     and backend. For example:
  299.  
  300.                     % f77 -n32 -TENV:misalignment=3 reshape.f
  301.                     Warning: Obsolete option "-TENV:misalignment=3" -- ignored
  302.                     Warning: Obsolete option "-TENV:misalignment=3" -- ignored
  303.  
  304.                     The -_T_E_N_V:_v_a_r_a_r_g_s__p_r_o_t_o_t_y_p_e_s=_T_R_U_E flag has been
  305.                     replaced by -_D_E_B_U_G:_v_a_r_a_r_g_s__p_r_o_t_o_t_y_p_e_s=_T_R_U_E.
  306.  
  307.                     For more information, please refer to the _f_7_7(1)
  308.                     and _D_E_B_U_G__g_r_o_u_p(5) man pages.
  309.  
  310.  
  311.  
  312.                     4.3.5  _F_i_l_l__a_n_d__A_l_i_g_n__D_i_r_e_c_t_i_v_e__S_u_p_p_o_r_t
  313.                     MIPSpro 7.2.1 Fortran 77 supports new types of
  314.                     directives to facilitate padding and alignment
  315.                     of variables within cachelines and pages of
  316.                     memory. They are outlined below.
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.                                                - 6 -
  334.  
  335.  
  336.  
  337.                     c*$*    fill_symbol (s, L1cacheline)
  338.                     c*$*    fill_symbol (s, L2cacheline)
  339.                     c*$*    fill_symbol (s, page)
  340.                     c*$*    fill_symbol (s, <user-specified-power-of-two>)
  341.                     c*$*    align_symbol (s, L1cacheline)
  342.                     c*$*    align_symbol (s, L2cacheline)
  343.                     c*$*    align_symbol (s, page)
  344.                     c*$*    align_symbol (s, <user-specified-power-of-two>)
  345.  
  346.  
  347.                     The fill_symbol and align_symbol directives take
  348.                     a symbol (i.e. a variable that may be a Fortran
  349.                     COMMON, or an automatic variable, but not a
  350.                     formal and not an element of a structured type
  351.                     like a struct or an array).  The second argument
  352.                     in the directive may be one of the keywords
  353.                     L1cacheline (machine specific first-level cache
  354.                     line size, typically 32 bytes), L2cacheline
  355.                     (machine specific second-level cache line size,
  356.                     typically 128 bytes), page (machine specific
  357.                     page size, typically 16 Kbytes), or a user-
  358.                     specified power-of-two value.
  359.  
  360.                     The align_symbol directive aligns the start of
  361.                     the named symbol at the specified alignment,
  362.                     i.e. the symbol "s" will start at the specified
  363.                     alignment boundary.
  364.  
  365.                     The fill_symbol directive pads the named symbol
  366.                     with additional storage so that the symbol is
  367.                     assured not to overlap with any other data item
  368.                     within the storage of the specified size. The
  369.                     additional padding required is heuristically
  370.                     divided between each end of the specified
  371.                     variable. For instance, a fill_symbol directive
  372.                     for the L1cacheline will guarantee that the
  373.                     specified symbol will not suffer from false-
  374.                     sharing for the L1 cache line.
  375.  
  376.                     For global variables these directives must be
  377.                     specified at the variable definition, and are
  378.                     optional at the declarations of the variable.
  379.  
  380.                     For COMMON block variables these directives are
  381.                     required at each declaration of the COMMON
  382.                     block. Since the directives modify the allocated
  383.                     storage and its alignment for the named symbol,
  384.                     inconsistent directive can lead to undefined
  385.                     results.
  386.  
  387.                     The align_symbol directive is ineffective for
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.                                                - 7 -
  400.  
  401.  
  402.  
  403.                     local variables of fixed-size symbols, such as
  404.                     simple scalars or arrays of known size. The
  405.                     directive continues to be effective for stack-
  406.                     allocated arrays of dynamically-determined size.
  407.  
  408.                     A variable cannot have both fill_symbol and
  409.                     align_symbol directives applied to it.
  410.  
  411.  
  412.                     4.3.6  _N_e_w _A_u_t_o_m_a_t_i_c _P_a_r_a_l_l_e_l_i_z_a_t_i_o_n _O_p_t_i_o_n
  413.                     _P_r_o_d_u_c_t   The 7.2 release of the MIPSpro
  414.                     compilers marks a major revision of the auto-
  415.                     parallelizer. The new product incorporates
  416.                     automatic parallelization into the other
  417.                     optimizations performed by the MIPSpro
  418.                     compilers.  Previous versions relied on
  419.                     preprocessors to provide source-to-source
  420.                     conversions prior to compilation. This change
  421.                     provides several benefits to developers:
  422.  
  423.                     Automatic parallelization is integrated with
  424.                     optimizations for single processors.
  425.  
  426.                     A set of options and pragmas consistent with the
  427.                     rest of the MIPSpro compilers.
  428.  
  429.                     Better run-time and compile-time performance.
  430.  
  431.                     For more information, please refer to the
  432.                     auto_p(5) man pages.
  433.  
  434.                     NOTE: In order to run the new automatic
  435.                     parallelization, you must purchase the MIPSpro
  436.                     Auto Parallelization Option (SC4-APO-7.2.1) and
  437.                     install the license for it (FEATURE name string
  438.                     = auto_pp).
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.